Remove a lot of Since annotations
authorMatthias Clasen <mclasen@redhat.com>
Mon, 25 Jun 2018 23:21:08 +0000 (19:21 -0400)
committerMatthias Clasen <mclasen@redhat.com>
Mon, 25 Jun 2018 23:55:04 +0000 (19:55 -0400)
4.0 will represent a clean epoch. We don't want to have
lots of noise in the docs about 2.x or 3.x.

38 files changed:
gdk/gdkdevicetool.h
gdk/gdkdisplay.c
gdk/gdkdnd.h
gdk/gdkevents.c
gdk/gdkevents.h
gdk/gdkeventsprivate.h
gdk/gdkframeclock.h
gdk/gdkmonitor.h
gdk/gdkseat.h
gdk/gdksurface.h
gdk/gdktypes.h
gdk/wayland/gdkdisplay-wayland.c
gsk/gskenums.h
gsk/gskroundedrect.h
gtk/gtkaccelgroup.c
gtk/gtkbbox.h
gtk/gtkcellareacontext.c
gtk/gtkcellrenderer.h
gtk/gtkcellrenderertext.c
gtk/gtkcontainer.c
gtk/gtkcsssection.h
gtk/gtkdialog.h
gtk/gtkentry.c
gtk/gtkenums.h
gtk/gtkeventcontrollerkey.c
gtk/gtkgesturestylus.c
gtk/gtkicontheme.h
gtk/gtklabel.c
gtk/gtkmain.c
gtk/gtkplacessidebar.c
gtk/gtkprinter.h
gtk/gtksearchbar.c
gtk/gtksearchentry.c
gtk/gtkstack.c
gtk/gtktextbuffer.c
gtk/gtkwidget.c
gtk/gtkwindow.c
modules/printbackends/gtkprintercups.c

index 4954592ea23008c49a88963ea40296a3e532acd5..66bab7e69949c62bb768d9e29be3f1ecbd802eb2 100644 (file)
@@ -47,8 +47,6 @@ typedef struct _GdkDeviceTool GdkDeviceTool;
  *
  * Indicates the specific type of tool being used being a tablet. Such as an
  * airbrush, pencil, etc.
- *
- * Since: 3.22
  */
 typedef enum {
   GDK_DEVICE_TOOL_TYPE_UNKNOWN,
index 8485e4f893f757d877bd4859057cc7bfb4dea99c..3375cb3ebd59dc130b19949e7e898753ab98ca81 100644 (file)
@@ -1288,8 +1288,6 @@ gdk_display_notify_startup_complete (GdkDisplay  *display,
  * if no ID has been defined.
  *
  * Returns: the startup notification ID for @display, or %NULL
- *
- * Since: 4.0
  */
 const gchar *
 gdk_display_get_startup_notification_id (GdkDisplay *display)
index caf79151bbc03317619fc0ae60153fc02ca9d62d..30e391b1ace1f99becd2ec790a42a9ab87922eae 100644 (file)
@@ -46,8 +46,6 @@ G_BEGIN_DECLS
  * @GDK_DRAG_CANCEL_ERROR: Unspecified error.
  *
  * Used in #GdkDragContext to the reason of a cancelled DND operation.
- *
- * Since: 3.20
  */
 typedef enum {
   GDK_DRAG_CANCEL_NO_TARGET,
index 272fe4429f3471ca69cb343aaddf82a400880d4e..178bbd3b85476050d34316fe219db675dffc7ad1 100644 (file)
@@ -2504,8 +2504,6 @@ gdk_event_get_axes (GdkEvent  *event,
  *
  * Returns: (transfer container) (element-type GdkTimeCoord) (nullable): a list
  *   of time and coordinates
- *
- * Since: 3.94
  */
 GList *
 gdk_event_get_motion_history (const GdkEvent *event)
index a43e7b439441a24f44cd04995e4c6551cad73e23..e8577af1a1edcd676b87fdf7e974d9518ffcd9e7 100644 (file)
@@ -67,8 +67,6 @@ G_BEGIN_DECLS
  *
  * Use this macro as the return value for continuing the propagation of
  * an event handler.
- *
- * Since: 3.4
  */
 #define GDK_EVENT_PROPAGATE     (FALSE)
 
@@ -77,8 +75,6 @@ G_BEGIN_DECLS
  *
  * Use this macro as the return value for stopping the propagation of
  * an event handler.
- *
- * Since: 3.4
  */
 #define GDK_EVENT_STOP          (TRUE)
 
@@ -87,8 +83,6 @@ G_BEGIN_DECLS
  *
  * The primary button. This is typically the left mouse button, or the
  * right button in a left-handed setup.
- *
- * Since: 3.4
  */
 #define GDK_BUTTON_PRIMARY      (1)
 
@@ -96,8 +90,6 @@ G_BEGIN_DECLS
  * GDK_BUTTON_MIDDLE:
  *
  * The middle button.
- *
- * Since: 3.4
  */
 #define GDK_BUTTON_MIDDLE       (2)
 
@@ -106,8 +98,6 @@ G_BEGIN_DECLS
  *
  * The secondary button. This is typically the right mouse button, or the
  * left button in a left-handed setup.
- *
- * Since: 3.4
  */
 #define GDK_BUTTON_SECONDARY    (3)
 
@@ -291,7 +281,7 @@ typedef enum
  * @GDK_SCROLL_LEFT: the surface is scrolled to the left.
  * @GDK_SCROLL_RIGHT: the surface is scrolled to the right.
  * @GDK_SCROLL_SMOOTH: the scrolling is determined by the delta values
- *   in scroll events. See gdk_event_get_scroll_deltas(). Since: 3.4
+ *   in scroll events. See gdk_event_get_scroll_deltas()
  *
  * Specifies the direction for scroll events.
  */
index d79beab2556060466643f5354af257df7e3efc52..b706c6f383b0ec7f2bf14739c8368a2ff849b3b0 100644 (file)
@@ -276,7 +276,7 @@ struct _GdkEventScroll
  * @hardware_keycode: the raw code of the key that was pressed or released.
  * @group: the keyboard group.
  * @is_modifier: a flag that indicates if @hardware_keycode is mapped to a
- *   modifier. Since 2.10
+ *   modifier
  *
  * Describes a key press or key release event.
  */
@@ -414,8 +414,6 @@ struct _GdkEventProximity
  * is unmapped), or if the same application grabs the pointer or keyboard
  * again. Note that implicit grabs (which are initiated by button presses)
  * can also cause #GdkEventGrabBroken events.
- *
- * Since: 2.8
  */
 struct _GdkEventGrabBroken {
   GdkEventAny any;
@@ -536,8 +534,6 @@ struct _GdkEventTouchpadPinch {
  *   device may have different current modes.
  *
  * Generated during %GDK_SOURCE_TABLET_PAD button presses and releases.
- *
- * Since: 3.22
  */
 struct _GdkEventPadButton {
   GdkEventAny any;
@@ -562,8 +558,6 @@ struct _GdkEventPadButton {
  * @value: The current value for the given axis.
  *
  * Generated during %GDK_SOURCE_TABLET_PAD interaction with tactile sensors.
- *
- * Since: 3.22
  */
 struct _GdkEventPadAxis {
   GdkEventAny any;
@@ -587,8 +581,6 @@ struct _GdkEventPadAxis {
  *   device may have different current modes.
  *
  * Generated during %GDK_SOURCE_TABLET_PAD mode switches in a group.
- *
- * Since: 3.22
  */
 struct _GdkEventPadGroupMode {
   GdkEventAny any;
index 801af3793fc697390f53997d330c71ab0b6747e2..d1a91f9c25810521a63638abc849483fcc6d05ac 100644 (file)
@@ -58,8 +58,6 @@ typedef struct _GdkFrameClockClass         GdkFrameClockClass;
  * #GdkFrameClockPhase is used to represent the different paint clock
  * phases that can be requested. The elements of the enumeration
  * correspond to the signals of #GdkFrameClock.
- *
- * Since: 3.8
  **/
 typedef enum {
   GDK_FRAME_CLOCK_PHASE_NONE          = 0,
index fe6836525e50ee811b93cdb11cd2cefb5b0f8683..79fd434660a343ca7a82f7a92fad18cb39042023 100644 (file)
@@ -50,8 +50,6 @@ typedef struct _GdkMonitorClass GdkMonitorClass;
  *
  * This enumeration describes how the red, green and blue components
  * of physical pixels on an output device are laid out.
- *
- * Since: 3.22
  */
 typedef enum {
   GDK_SUBPIXEL_LAYOUT_UNKNOWN,
index bb0eb069f2c508a7a67d7f991529dcb2ba3a61d8..14d7f83a63a22f4a31385f73c6c6b4523a9852a4 100644 (file)
@@ -47,8 +47,6 @@ G_BEGIN_DECLS
  * @GDK_SEAT_CAPABILITY_ALL: The union of all capabilities
  *
  * Flags describing the seat capabilities.
- *
- * Since: 3.20
  */
 typedef enum {
   GDK_SEAT_CAPABILITY_NONE          = 0,
@@ -71,8 +69,6 @@ typedef enum {
  * grabbed. A typical action would be ensuring the surface is
  * visible, although there's room for other initialization
  * actions.
- *
- * Since: 3.20
  */
 typedef void (* GdkSeatGrabPrepareFunc) (GdkSeat   *seat,
                                          GdkSurface *surface,
index bfb8f5aeff9875dba351e210370ff410a2211ecc..a1b800b8f43f144423c5153f5d19b1bf1374c5e2 100644 (file)
@@ -47,7 +47,7 @@ typedef struct _GdkGeometry          GdkGeometry;
  *  #GtkMenu)
  * @GDK_SURFACE_SUBSURFACE: subsurface; This surface is visually
  *  tied to a toplevel, and is moved/stacked with it. Currently this window
- *  type is only implemented in Wayland. Since 3.14
+ *  type is only implemented in Wayland
  *
  * Describes the kind of surface.
  */
@@ -215,9 +215,6 @@ typedef enum
  *
  * In general, when multiple flags are set, flipping should take precedence over
  * sliding, which should take precedence over resizing.
- *
- * Since: 3.22
- * Stability: Unstable
  */
 typedef enum
 {
@@ -264,8 +261,6 @@ typedef enum
  *
  * Indicates which monitor (in a multi-head setup) a surface should span over
  * when in fullscreen mode.
- *
- * Since: 3.8
  **/
 typedef enum
 {
@@ -375,16 +370,15 @@ struct _GdkGeometry
  * @GDK_SURFACE_STATE_ABOVE: the surface is kept above other surfaces.
  * @GDK_SURFACE_STATE_BELOW: the surface is kept below other surfaces.
  * @GDK_SURFACE_STATE_FOCUSED: the surface is presented as focused (with active decorations).
- * @GDK_SURFACE_STATE_TILED: the surface is in a tiled state, Since 3.10. Since 3.91.2, this
- *                          is deprecated in favor of per-edge information.
- * @GDK_SURFACE_STATE_TOP_TILED: whether the top edge is tiled, Since 3.91.2
- * @GDK_SURFACE_STATE_TOP_RESIZABLE: whether the top edge is resizable, Since 3.91.2
- * @GDK_SURFACE_STATE_RIGHT_TILED: whether the right edge is tiled, Since 3.91.2
- * @GDK_SURFACE_STATE_RIGHT_RESIZABLE: whether the right edge is resizable, Since 3.91.2
- * @GDK_SURFACE_STATE_BOTTOM_TILED: whether the bottom edge is tiled, Since 3.91.2
- * @GDK_SURFACE_STATE_BOTTOM_RESIZABLE: whether the bottom edge is resizable, Since 3.91.2
- * @GDK_SURFACE_STATE_LEFT_TILED: whether the left edge is tiled, Since 3.91.2
- * @GDK_SURFACE_STATE_LEFT_RESIZABLE: whether the left edge is resizable, Since 3.91.2
+ * @GDK_SURFACE_STATE_TILED: the surface is in a tiled state. Deprecated
+ * @GDK_SURFACE_STATE_TOP_TILED: whether the top edge is tiled
+ * @GDK_SURFACE_STATE_TOP_RESIZABLE: whether the top edge is resizable
+ * @GDK_SURFACE_STATE_RIGHT_TILED: whether the right edge is tiled
+ * @GDK_SURFACE_STATE_RIGHT_RESIZABLE: whether the right edge is resizable
+ * @GDK_SURFACE_STATE_BOTTOM_TILED: whether the bottom edge is tiled
+ * @GDK_SURFACE_STATE_BOTTOM_RESIZABLE: whether the bottom edge is resizable
+ * @GDK_SURFACE_STATE_LEFT_TILED: whether the left edge is tiled
+ * @GDK_SURFACE_STATE_LEFT_RESIZABLE: whether the left edge is resizable
  *
  * Specifies the state of a toplevel surface.
  */
index cdd5808e7800c0bc820b58a08f1f9b2d3a0c7984..b967ad7259489f94d6f3fb657b9fceac329ad50d 100644 (file)
@@ -196,9 +196,9 @@ typedef enum
  * @GDK_MODIFIER_RESERVED_23_MASK: A reserved bit flag; do not use in your own code
  * @GDK_MODIFIER_RESERVED_24_MASK: A reserved bit flag; do not use in your own code
  * @GDK_MODIFIER_RESERVED_25_MASK: A reserved bit flag; do not use in your own code
- * @GDK_SUPER_MASK: the Super modifier. Since 2.10
- * @GDK_HYPER_MASK: the Hyper modifier. Since 2.10
- * @GDK_META_MASK: the Meta modifier. Since 2.10
+ * @GDK_SUPER_MASK: the Super modifier
+ * @GDK_HYPER_MASK: the Hyper modifier
+ * @GDK_META_MASK: the Meta modifier
  * @GDK_MODIFIER_RESERVED_29_MASK: A reserved bit flag; do not use in your own code
  * @GDK_RELEASE_MASK: not used in GDK itself. GTK+ uses it to differentiate
  *  between (keyval, modifiers) pairs from key press and release events.
@@ -210,7 +210,7 @@ typedef enum
  *
  * Like the X Window System, GDK supports 8 modifier keys and 5 mouse buttons.
  *
- * Since 2.10, GDK recognizes which of the Meta, Super or Hyper keys are mapped
+ * GDK recognizes which of the Meta, Super or Hyper keys are mapped
  * to Mod2 - Mod5, and indicates this by setting %GDK_SUPER_MASK,
  * %GDK_HYPER_MASK or %GDK_META_MASK in the state field of key events.
  *
@@ -299,8 +299,6 @@ typedef enum
  * invoking menu shortcuts (accelerators), whereas on Apple computers
  * it’s the Command key (which correspond to %GDK_CONTROL_MASK and
  * %GDK_MOD2_MASK, respectively).
- *
- * Since: 3.4
  **/
 typedef enum
 {
@@ -322,7 +320,7 @@ typedef enum
  * @GDK_GRAB_NOT_VIEWABLE: the grab surface or the @confine_to surface are not
  *  viewable.
  * @GDK_GRAB_FROZEN: the resource is frozen by an active grab of another client.
- * @GDK_GRAB_FAILED: the grab failed for some other reason. Since 3.16
+ * @GDK_GRAB_FAILED: the grab failed for some other reason
  *
  * Returned by gdk_device_grab() to indicate success or the reason for the
  * failure of the grab attempt.
@@ -371,13 +369,12 @@ typedef enum
  * @GDK_PROPERTY_CHANGE_MASK: receive property change events
  * @GDK_PROXIMITY_IN_MASK: receive proximity in events
  * @GDK_PROXIMITY_OUT_MASK: receive proximity out events
- * @GDK_SUBSTRUCTURE_MASK: receive events about surface configuration changes of
- *   child surfaces
+ * @GDK_SUBSTRUCTURE_MASK: receive events about surface configuration changes of child surfaces
  * @GDK_SCROLL_MASK: receive scroll events
- * @GDK_TOUCH_MASK: receive touch events. Since 3.4
- * @GDK_SMOOTH_SCROLL_MASK: receive smooth scrolling events. Since 3.4
-   @GDK_TOUCHPAD_GESTURE_MASK: receive touchpad gesture events. Since 3.18
- * @GDK_TABLET_PAD_MASK: receive tablet pad events. Since 3.22
+ * @GDK_TOUCH_MASK: receive touch events
+ * @GDK_SMOOTH_SCROLL_MASK: receive smooth scrolling events
+   @GDK_TOUCHPAD_GESTURE_MASK: receive touchpad gesture events
+ * @GDK_TABLET_PAD_MASK: receive tablet pad events
  * @GDK_ALL_EVENTS_MASK: the combination of all the above event masks.
  *
  * A set of bit-flags to indicate which events a surface is to receive.
@@ -387,11 +384,6 @@ typedef enum
  * See the [input handling overview][chap-input-handling] for details of
  * [event masks][event-masks] and [event propagation][event-propagation].
  *
- * Since GTK 3.8, motion events are already compressed by default, independent
- * of this mechanism. This compression can be disabled with
- * gdk_surface_set_event_compression(). See the documentation of that function
- * for details.
- *
  * If %GDK_TOUCH_MASK is enabled, the surface will receive touch events
  * from touch-enabled devices. Those will come as sequences of #GdkEventTouch
  * with type %GDK_TOUCH_UPDATE, enclosed by two events with
@@ -432,12 +424,10 @@ typedef enum
  * @GDK_GL_ERROR_NOT_AVAILABLE: OpenGL support is not available
  * @GDK_GL_ERROR_UNSUPPORTED_FORMAT: The requested visual format is not supported
  * @GDK_GL_ERROR_UNSUPPORTED_PROFILE: The requested profile is not supported
- * @GDK_GL_ERROR_COMPILATION_FAILED: The shader compilation failed (available since 3.22)
- * @GDK_GL_ERROR_LINK_FAILED: The shader linking failed (available since 3.22)
+ * @GDK_GL_ERROR_COMPILATION_FAILED: The shader compilation failed
+ * @GDK_GL_ERROR_LINK_FAILED: The shader linking failed
  *
  * Error enumeration for #GdkGLContext.
- *
- * Since: 3.16
  */
 typedef enum {
   GDK_GL_ERROR_NOT_AVAILABLE,
@@ -454,8 +444,6 @@ typedef enum {
  * @GDK_VULKAN_ERROR_NOT_AVAILABLE: Vulkan support is not available on this Surface
  *
  * Error enumeration for #GdkVulkanContext.
- *
- * Since: 3.90
  */
 typedef enum {
   GDK_VULKAN_ERROR_UNSUPPORTED,
@@ -519,9 +507,9 @@ typedef enum
  * @GDK_AXIS_XTILT: the axis is used for x tilt information.
  * @GDK_AXIS_YTILT: the axis is used for y tilt information.
  * @GDK_AXIS_WHEEL: the axis is used for wheel information.
- * @GDK_AXIS_DISTANCE: the axis is used for pen/tablet distance information. (Since: 3.22)
- * @GDK_AXIS_ROTATION: the axis is used for pen rotation information. (Since: 3.22)
- * @GDK_AXIS_SLIDER: the axis is used for pen slider information. (Since: 3.22)
+ * @GDK_AXIS_DISTANCE: the axis is used for pen/tablet distance information
+ * @GDK_AXIS_ROTATION: the axis is used for pen rotation information
+ * @GDK_AXIS_SLIDER: the axis is used for pen slider information
  * @GDK_AXIS_LAST: a constant equal to the numerically highest axis value.
  *
  * An enumeration describing the way in which a device
@@ -560,8 +548,6 @@ typedef enum
  * @GDK_AXIS_FLAG_SLIDER: Slider axis is present
  *
  * Flags describing the current capabilities of a device/tool.
- *
- * Since: 3.22
  */
 typedef enum
 {
index 77b948a1f22a23f2f2a2dda15421d6361809af2d..6d00960adf798d93fa15858292b253f008e4ae77 100644 (file)
@@ -857,8 +857,6 @@ gdk_wayland_display_get_next_serial (GdkDisplay *display)
  * if no ID has been defined.
  *
  * Returns: the startup notification ID for @display, or %NULL
- *
- * Since: 4.0
  */
 const gchar *
 gdk_wayland_display_get_startup_notification_id (GdkDisplay  *display)
index b605509047e9e47e5c3c1eda7718e721437edacc..4c17675ef3d54af16c18f03dbde45b486f7523ab 100644 (file)
@@ -48,8 +48,6 @@
  * @GSK_OFFSET_NODE: A node that renders its child after applying a 2D translation
  *
  * The type of a node determines what the node is rendering.
- *
- * Since: 3.90
  **/
 typedef enum {
   GSK_NOT_A_RENDER_NODE = 0,
@@ -89,8 +87,6 @@ typedef enum {
  *
  * The actual implementation of each filter is deferred to the
  * rendering pipeline.
- *
- * Since: 3.90
  */
 typedef enum {
   GSK_SCALING_FILTER_LINEAR,
@@ -122,8 +118,6 @@ typedef enum {
  *
  * The implementation of each blend mode is deferred to the
  * rendering pipeline.
- *
- * Since: 3.90
  */
 typedef enum {
   GSK_BLEND_MODE_DEFAULT = 0,
index 28384417e1640a551fb030f90081acfc4ee50e35..378591af4c0f54d2e31b940fe7ec95c75f369027 100644 (file)
@@ -36,8 +36,6 @@ G_BEGIN_DECLS
  *
  * Initializes a #GskRoundedRect when declaring it.
  * All corner sizes will be initialized to 0.
- *
- * Since: 3.90
  */
 #define GSK_ROUNDED_RECT_INIT(_x,_y,_w,_h)       (GskRoundedRect) { .bounds = GRAPHENE_RECT_INIT(_x,_y,_w,_h), \
                                                                     .corner = { \
@@ -60,8 +58,6 @@ G_BEGIN_DECLS
  * All functions taking a #GskRoundedRect as an argument will internally operate on
  * a normalized copy; all functions returning a #GskRoundedRect will always return
  * a normalized one.
- *
- * Since: 3.90
  */
 typedef struct _GskRoundedRect           GskRoundedRect;
 
index 18db6312121aae69bae4bc5ae8203b0d6c34eb63..31f8f92e1f27291bce78a142a87bd5664e96440b 100644 (file)
@@ -694,8 +694,6 @@ gtk_accel_group_connect_by_path (GtkAccelGroup *accel_group,
  * Removes an accelerator previously installed through
  * gtk_accel_group_connect().
  *
- * Since 2.20 @closure can be %NULL.
- *
  * Returns: %TRUE if the closure was found and got disconnected
  */
 gboolean
index c8bcf2e1ebbb343b8fb5988fa7fe71f5d9e36a77..9b92665bf2db39695c99d7ca87f0edf9c6d3f192 100644 (file)
@@ -80,11 +80,11 @@ struct _GtkButtonBoxClass
  *   (on the left for a HBox, or the top for a VBox).
  * @GTK_BUTTONBOX_END: Buttons are grouped towards the end of the box,
  *   (on the right for a HBox, or the bottom for a VBox).
- * @GTK_BUTTONBOX_CENTER: Buttons are centered in the box. Since 2.12.
+ * @GTK_BUTTONBOX_CENTER: Buttons are centered in the box
  * @GTK_BUTTONBOX_EXPAND: Buttons expand to fill the box. This entails giving
  *   buttons a "linked" appearance, making button sizes homogeneous, and
  *   setting spacing to 0 (same as calling gtk_box_set_homogeneous() and
- *   gtk_box_set_spacing() manually). Since 3.12.
+ *   gtk_box_set_spacing() manually)
  *
  * Used to dictate the style that a #GtkButtonBox uses to layout the buttons it
  * contains.
index 36691235df802a664e6ee2194656e377bf77c554..c9ed22063b5f2a9c82f0bf90b2bb3742a663ec1d 100644 (file)
@@ -356,8 +356,6 @@ gtk_cell_area_context_get_area (GtkCellAreaContext *context)
  * in the allocated width necessitates a recalculation
  * of all the displayed row heights using
  * gtk_cell_area_get_preferred_height_for_width().
- *
- * Since 3.0
  */
 void
 gtk_cell_area_context_reset (GtkCellAreaContext *context)
@@ -385,8 +383,6 @@ gtk_cell_area_context_reset (GtkCellAreaContext *context)
  * and vertical orientations producing a homogeneous effect of the
  * rows. This is generally the case for #GtkTreeView when
  * #GtkTreeView:fixed-height-mode is enabled.
- *
- * Since 3.0
  */
 void
 gtk_cell_area_context_allocate (GtkCellAreaContext *context,
index 2b297e1c59267bb5c7d678181e4c12ccdf6b2c51..c5d8c55a9122fbe1af2efa15bfc2fea64534c1a8 100644 (file)
@@ -35,8 +35,8 @@ G_BEGIN_DECLS
  * @GTK_CELL_RENDERER_INSENSITIVE: The cell is drawn in an insensitive manner
  * @GTK_CELL_RENDERER_SORTED: The cell is in a sorted row
  * @GTK_CELL_RENDERER_FOCUSED: The cell is in the focus row.
- * @GTK_CELL_RENDERER_EXPANDABLE: The cell is in a row that can be expanded. Since 3.4
- * @GTK_CELL_RENDERER_EXPANDED: The cell is in a row that is expanded. Since 3.4
+ * @GTK_CELL_RENDERER_EXPANDABLE: The cell is in a row that can be expanded
+ * @GTK_CELL_RENDERER_EXPANDED: The cell is in a row that is expanded
  *
  * Tells how a cell is to be rendered.
  */
index 1e46ea0c56406d22533fe1ca47f57229c9e085c7..f7ee9aaee272b6b9587a69ef7719784396112a54 100644 (file)
@@ -539,8 +539,6 @@ gtk_cell_renderer_text_class_init (GtkCellRendererTextClass *class)
    *
    * The text that will be displayed in the #GtkCellRenderer if
    * #GtkCellRendererText:editable is %TRUE and the cell is empty.
-   *
-   * Since 3.6
    */
   text_cell_renderer_props[PROP_PLACEHOLDER_TEXT] =
       g_param_spec_string ("placeholder-text",
index 9f11262a7c178d5a363edf5ca6767bc51336561e..00427aae05f1e214b3dd57934342ba7b6a78fad4 100644 (file)
  * a <packing> element for children, which can contain multiple <property>
  * elements that specify child properties for the child.
  * 
- * Since 2.16, child properties can also be marked as translatable using
+ * Child properties can also be marked as translatable using
  * the same “translatable”, “comments” and “context” attributes that are used
  * for regular properties.
  *
- * Since 3.16, containers can have a <focus-chain> element containing multiple
+ * Containers can have a <focus-chain> element containing multiple
  * <widget> elements, one for each child that should be added to the focus
  * chain. The ”name” attribute gives the id of the widget.
  *
index 8553633fcd92b2712228d6e6ad2b83df1e321125..8dc7ac90b565656ff0137b18bf87a5e44f734f6d 100644 (file)
@@ -41,7 +41,7 @@ G_BEGIN_DECLS
  *   a CSS variable.
  * @GTK_CSS_SECTION_VALUE: The section defines the value of a CSS declaration.
  * @GTK_CSS_SECTION_KEYFRAMES: The section defines keyframes. See [CSS
- *   Animations](http://dev.w3.org/csswg/css3-animations/#keyframes) for details. Since 3.6
+ *   Animations](http://dev.w3.org/csswg/css3-animations/#keyframes) for details
  *
  * The different types of sections indicate parts of a CSS document as
  * parsed by GTK’s CSS parser. They are oriented towards the
index 377a155f5fbd55ebc8bf9c5b05e7c378faaa867f..68ae23126e16bade8f844ac06d12a6dc099a0eac 100644 (file)
@@ -40,7 +40,7 @@ G_BEGIN_DECLS
  * @GTK_DIALOG_DESTROY_WITH_PARENT: Destroy the dialog when its
  *     parent is destroyed, see gtk_window_set_destroy_with_parent()
  * @GTK_DIALOG_USE_HEADER_BAR: Create dialog with actions in header
- *     bar instead of action area. Since 3.12.
+ *     bar instead of action area
  *
  * Flags used to influence dialog construction.
  */
index 5f64a75f14ecdd5e13dcdfb51c3800c0e09e002b..105bd935ca242f671b3f3a7667ec97574a731224 100644 (file)
  * In this mode, entered text is displayed using a “invisible” character.
  * By default, GTK+ picks the best invisible character that is available
  * in the current font, but it can be changed with
- * gtk_entry_set_invisible_char(). Since 2.16, GTK+ displays a warning
+ * gtk_entry_set_invisible_char(). GTK+ displays a warning
  * when Caps Lock or input methods might interfere with entering text in
  * a password entry. The warning can be turned off with the
  * #GtkEntry:caps-lock-warning property.
  *
- * Since 2.16, GtkEntry has the ability to display progress or activity
+ * GtkEntry has the ability to display progress or activity
  * information behind the text. To make an entry display such information,
  * use gtk_entry_set_progress_fraction() or gtk_entry_set_progress_pulse_step().
  *
index 2fd2739998716641f898edcd077d93bd24aaf951..57ac101e5f225af8010db281e04d1968d04973ea 100644 (file)
@@ -51,7 +51,7 @@ G_BEGIN_DECLS
  *     or top
  * @GTK_ALIGN_CENTER: center natural width of widget inside the
  *     allocation
- * @GTK_ALIGN_BASELINE: align the widget according to the baseline. Since 3.10.
+ * @GTK_ALIGN_BASELINE: align the widget according to the baseline
  *
  * Controls how a widget deals with extra space in a single (x or y)
  * dimension.
@@ -85,7 +85,7 @@ typedef enum
  * @GTK_ARROW_DOWN: Represents a downward pointing arrow.
  * @GTK_ARROW_LEFT: Represents a left pointing arrow.
  * @GTK_ARROW_RIGHT: Represents a right pointing arrow.
- * @GTK_ARROW_NONE: No arrow. Since 2.10.
+ * @GTK_ARROW_NONE: No arrow.
  *
  * Used to indicate the direction in which an arrow should point.
  */
@@ -912,9 +912,9 @@ typedef enum
  *     first word of each sentence
  * @GTK_INPUT_HINT_INHIBIT_OSK: Suggest to not show an onscreen keyboard
  *     (e.g for a calculator that already has all the keys).
- * @GTK_INPUT_HINT_VERTICAL_WRITING: The text is vertical. Since 3.18
- * @GTK_INPUT_HINT_EMOJI: Suggest offering Emoji support. Since 3.22.20
- * @GTK_INPUT_HINT_NO_EMOJI: Suggest not offering Emoji support. Since 3.22.20
+ * @GTK_INPUT_HINT_VERTICAL_WRITING: The text is vertical
+ * @GTK_INPUT_HINT_EMOJI: Suggest offering Emoji support
+ * @GTK_INPUT_HINT_NO_EMOJI: Suggest not offering Emoji support
  *
  * Describes hints that might be taken into account by input methods
  * or applications. Note that input methods may already tailor their
index a998a0af8924b529c7573301205feeb2113de571..ecac19478b1584275b313f1ab1e8e549b424dd42 100644 (file)
@@ -231,8 +231,6 @@ gtk_event_controller_key_set_im_context (GtkEventControllerKey *controller,
  * Gets the IM context of a key controller.
  *
  * Returns: (transfer none): the IM context
- *
- * Since: 3.94
  **/
 GtkIMContext *
 gtk_event_controller_key_get_im_context (GtkEventControllerKey *controller)
index 294fa293a326a91f993bde524bd0d3b77df0b929..8c011c35014cb17f61615b5b18404c1899927b45 100644 (file)
@@ -135,8 +135,6 @@ gtk_gesture_stylus_init (GtkGestureStylus *gesture)
  * Creates a new #GtkGestureStylus.
  *
  * Returns: a newly created stylus gesture
- *
- * Since: 3.94
  **/
 GtkGesture *
 gtk_gesture_stylus_new (void)
index b618ffec0d8dbee35ec0821e37a426b2c5d26ef6..057d2fe6f32ca0d1abb8c23a825f552256792271 100644 (file)
@@ -112,17 +112,17 @@ struct _GtkIconThemeClass
  * @GTK_ICON_LOOKUP_GENERIC_FALLBACK: Try to shorten icon name at '-'
  *   characters before looking at inherited themes. This flag is only
  *   supported in functions that take a single icon name. For more general
- *   fallback, see gtk_icon_theme_choose_icon(). Since 2.12.
+ *   fallback, see gtk_icon_theme_choose_icon()
  * @GTK_ICON_LOOKUP_FORCE_SIZE: Always get the icon scaled to the
- *   requested size. Since 2.14.
+ *   requested size
  * @GTK_ICON_LOOKUP_FORCE_REGULAR: Try to always load regular icons, even
- *   when symbolic icon names are given. Since 3.14.
+ *   when symbolic icon names are given
  * @GTK_ICON_LOOKUP_FORCE_SYMBOLIC: Try to always load symbolic icons, even
- *   when regular icon names are given. Since 3.14.
+ *   when regular icon names are given
  * @GTK_ICON_LOOKUP_DIR_LTR: Try to load a variant of the icon for left-to-right
- *   text direction. Since 3.14.
+ *   text direction
  * @GTK_ICON_LOOKUP_DIR_RTL: Try to load a variant of the icon for right-to-left
- *   text direction. Since 3.14.
+ *   text direction
  * 
  * Used to specify options for gtk_icon_theme_lookup_icon()
  */
index e361b1ba36bcb6ed67cf0049307487b7c036cb66..f007fecf37ebb5c0ab9c2a0daae19d4cb94174e3 100644 (file)
  *
  * # Links
  *
- * Since 2.18, GTK+ supports markup for clickable hyperlinks in addition
+ * GTK+ supports markup for clickable hyperlinks in addition
  * to regular Pango markup. The markup for links is borrowed from HTML,
  * using the `<a>` with “href“, “title“ and “class“ attributes. GTK+ renders links
  * similar to the way they appear in web browsers, with colored, underlined
index b285c517b6f5e224e1af5c33eccf93c103fb4c2a..3377ee3742e07d4077402f4ded72bb50218dc95f 100644 (file)
@@ -809,7 +809,7 @@ gtk_init_check (void)
  * your program to fall back to a textual interface you want to
  * call gtk_init_check() instead.
  *
- * Since 2.18, GTK+ calls `signal (SIGPIPE, SIG_IGN)`
+ * GTK+ calls `signal (SIGPIPE, SIG_IGN)`
  * during initialization, to ignore SIGPIPE signals, since these are
  * almost never wanted in graphical applications. If you do need to
  * handle SIGPIPE for some reason, reset the handler after gtk_init(),
index e883cb068600c5771e75c1964119860d564b69a5..95683c6622ad245fde7c7b41353ed9b4eb6fb6c9 100644 (file)
@@ -4448,7 +4448,7 @@ gtk_places_sidebar_class_init (GtkPlacesSidebarClass *class)
    * emitted) every time the user activates the contextual menu.
    *
    * Before 3.18, the @container always was a #GtkMenu, and you were expected
-   * to add your items as #GtkMenuItems. Since 3.18, the popup may be implemented
+   * to add your items as #GtkMenuItems. The popup may be implemented
    * as a #GtkPopover, in which case @container will be something else, e.g. a
    * #GtkBox, to which you may add #GtkModelButtons or other widgets, such as
    * #GtkEntries, #GtkSpinButtons, etc. If your application can deal with this
index a3e3eb54a3eb17641bc3e7ea3808055ce481a9e8..205d04fb65d73616a0070d62770e4563fda6aa9b 100644 (file)
@@ -45,9 +45,9 @@ G_BEGIN_DECLS
  *   the printer in Postscript format
  * @GTK_PRINT_CAPABILITY_PREVIEW: Print dialog will offer a preview
  * @GTK_PRINT_CAPABILITY_NUMBER_UP: Print dialog will offer printing multiple
- *   pages per sheet. Since 2.12
+ *   pages per sheet
  * @GTK_PRINT_CAPABILITY_NUMBER_UP_LAYOUT: Print dialog will allow to rearrange
- *   pages when printing multiple pages per sheet. Since 2.14
+ *   pages when printing multiple pages per sheet
  *
  * An enum for specifying which features the print dialog should offer.
  * If neither %GTK_PRINT_CAPABILITY_GENERATE_PDF nor
index 8f26e8ecf425bb1fe2000732c3c56743db87455e..68bd94de3c2e40fde99e63dcc657290e43b16d74 100644 (file)
@@ -710,8 +710,6 @@ capture_widget_key_handled (GtkEventControllerKey *controller,
  *
  * If key events are handled by the search bar, the bar will
  * be shown, and the entry populated with the entered text.
- *
- * Since: 3.94
  **/
 void
 gtk_search_bar_set_key_capture_widget (GtkSearchBar *bar,
@@ -758,8 +756,6 @@ gtk_search_bar_set_key_capture_widget (GtkSearchBar *bar,
  * Gets the widget that @bar is capturing key events from.
  *
  * Returns: (transfer none): The key capture widget.
- *
- * Since: 3.94
  **/
 GtkWidget *
 gtk_search_bar_get_key_capture_widget (GtkSearchBar *bar)
index 7e50642f1774c525fe6a397fe5f01b8355e49c8d..693fe6d48593605cfef3c6f3129b6324241cb2b6 100644 (file)
@@ -490,8 +490,6 @@ capture_widget_key_handled (GtkEventControllerKey *controller,
  * If the entry is part of a #GtkSearchBar, it is preferable
  * to call gtk_search_bar_set_key_capture_widget() instead, which
  * will reveal the entry in addition to triggering the search entry.
- *
- * Since: 3.94
  **/
 void
 gtk_search_entry_set_key_capture_widget (GtkSearchEntry *entry,
@@ -535,8 +533,6 @@ gtk_search_entry_set_key_capture_widget (GtkSearchEntry *entry,
  * Gets the widget that @entry is capturing key events from.
  *
  * Returns: (transfer none): The key capture widget.
- *
- * Since: 3.94
  **/
 GtkWidget *
 gtk_search_entry_get_key_capture_widget (GtkSearchEntry *entry)
index 05cf9e785d86f254cf330e689d1a538cb24dd5fd..a3d36a86033b8a527bdfe2e07b3d973e8dc5e19f 100644 (file)
@@ -1252,7 +1252,7 @@ gtk_stack_get_child_by_name (GtkStack    *stack,
  * size for all its children. If it isn't, the stack
  * may change size when a different child becomes visible.
  *
- * Since 3.16, homogeneity can be controlled separately
+ * Homogeneity can be controlled separately
  * for horizontal and vertical size, with the
  * #GtkStack:hhomogeneous and #GtkStack:vhomogeneous.
  */
index e6c1a6c62fa95aaf7c9881126d958ae0a59952fc..31d4bc99111e2d0cf19cdbb59bb0b3e9178a6615 100644 (file)
@@ -3054,7 +3054,7 @@ gtk_text_buffer_remove_all_tags (GtkTextBuffer     *buffer,
  *
  * Before the 3.20 version, it was not allowed to pass an invalid location.
  *
- * Since the 3.20 version, if @line_number is greater than the number of lines
+ * If @line_number is greater than the number of lines
  * in the @buffer, the end iterator is returned. And if @char_offset is off the
  * end of the line, the iterator at the end of the line is returned.
  **/
@@ -3098,9 +3098,7 @@ gtk_text_buffer_get_iter_at_line_offset (GtkTextBuffer *buffer,
  * @byte_index must be the start of a UTF-8 character. Note bytes, not
  * characters; UTF-8 may encode one character as multiple bytes.
  *
- * Before the 3.20 version, it was not allowed to pass an invalid location.
- *
- * Since the 3.20 version, if @line_number is greater than the number of lines
+ * If @line_number is greater than the number of lines
  * in the @buffer, the end iterator is returned. And if @byte_index is off the
  * end of the line, the iterator at the end of the line is returned.
  **/
index 6f324522c2ff1e54f8d3fa3d9ceb5bceeba86652..234c1302dd0c4fd9d2e964b5e705a2dab33bcf42 100644 (file)
  * Otherwise, you would not properly consider widget margins,
  * #GtkSizeGroup, and so forth.
  *
- * Since 3.10 GTK+ also supports baseline vertical alignment of widgets. This
+ * GTK+ also supports baseline vertical alignment of widgets. This
  * means that widgets are positioned such that the typographical baseline of
  * widgets in the same row are aligned. This happens if a widget supports baselines,
  * has a vertical alignment of %GTK_ALIGN_BASELINE, and is inside a widget
index 29ecb22eb0b82c4095ac7ad15b8e93175b24f35f..012f4efa58afe9d2c1e7ce53f2ac1f4cd386bc9c 100644 (file)
@@ -9934,8 +9934,6 @@ gtk_window_get_group (GtkWindow *window)
  * Returns whether @window has an explicit window group.
  *
  * Returns: %TRUE if @window has an explicit window group.
- *
- * Since 2.22
  **/
 gboolean
 gtk_window_has_group (GtkWindow *window)
index 525382aa8a795293160a6d58e98f4b8218132217..b97da6180500675eb1abb06ff6893e3720f031d4 100644 (file)
@@ -576,8 +576,6 @@ colord_printer_details_aquired_cb (GtkPrinterCups *printer,
  * Creates a new #GtkPrinterCups.
  *
  * Returns: a new #GtkPrinterCups
- *
- * Since: 2.10
  **/
 GtkPrinterCups *
 gtk_printer_cups_new (const char      *name,